<!DOCTYPE html>
<html lang="en">
<head>
	<meta charset="UTF-8">
	<meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
	<title>cat nodes API | ElasticSearch 7.7 权威指南中文版</title>
	<meta name="keywords" content="ElasticSearch 权威指南中文版, elasticsearch 7, es7, 实时数据分析，实时数据检索" />
    <meta name="description" content="ElasticSearch 权威指南中文版, elasticsearch 7, es7, 实时数据分析，实时数据检索" />
    <!-- Give IE8 a fighting chance -->
    <!--[if lt IE 9]>
    <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
    <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
    <![endif]-->
	<link rel="stylesheet" type="text/css" href="../static/styles.css" />
	<script>
	var _link = 'cat-nodes.html';
    </script>
</head>
<body>
<div class="main-container">
    <section id="content">
        <div class="content-wrapper">
            <section id="guide" lang="zh_cn">
                <div class="container">
                    <div class="row">
                        <div class="col-xs-12 col-sm-8 col-md-8 guide-section">
                            <div style="color:gray; word-break: break-all; font-size:12px;">原英文版地址: <a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.7/cat-nodes.html" rel="nofollow" target="_blank">https://www.elastic.co/guide/en/elasticsearch/reference/7.7/cat-nodes.html</a>, 原文档版权归 www.elastic.co 所有<br/>本地英文版地址: <a href="../en/cat-nodes.html" rel="nofollow" target="_blank">../en/cat-nodes.html</a></div>
                        <!-- start body -->
                  <div class="page_header">
<strong>重要</strong>: 此版本不会发布额外的bug修复或文档更新。最新信息请参考 <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html" rel="nofollow">当前版本文档</a>。
</div>
<div id="content">
<div class="breadcrumbs">
<span class="breadcrumb-link"><a href="index.html">Elasticsearch Guide [7.7]</a></span>
»
<span class="breadcrumb-link"><a href="rest-apis.html">REST APIs</a></span>
»
<span class="breadcrumb-link"><a href="cat.html">cat APIs</a></span>
»
<span class="breadcrumb-node">cat nodes API</span>
</div>
<div class="navheader">
<span class="prev">
<a href="cat-nodeattrs.html">« cat nodeattrs API</a>
</span>
<span class="next">
<a href="cat-pending-tasks.html">cat pending tasks API »</a>
</span>
</div>
<div class="section">
<div class="titlepage"><div><div>
<h2 class="title">
<a id="cat-nodes"></a>cat nodes API<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elastic/elasticsearch/edit/7.7/docs/reference/cat/nodes.asciidoc">edit</a>
</h2>
</div></div></div>

<p>Returns information about a cluster’s nodes.</p>
<div class="section">
<div class="titlepage"><div><div>
<h3 class="title">
<a id="cat-nodes-api-request"></a>Request<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elastic/elasticsearch/edit/7.7/docs/reference/cat/nodes.asciidoc">edit</a>
</h3>
</div></div></div>
<p><code class="literal">GET /_cat/nodes</code></p>
</div>

<div class="section">
<div class="titlepage"><div><div>
<h3 class="title">
<a id="cat-nodes-api-query-params"></a>Query parameters<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elastic/elasticsearch/edit/7.7/docs/reference/cat/nodes.asciidoc">edit</a>
</h3>
</div></div></div>
<div class="variablelist">
<dl class="variablelist">
<dt>
<span class="term">
<code class="literal">bytes</code>
</span>
</dt>
<dd>
(Optional, <a class="xref" href="common-options.html#byte-units" title="Byte size units">byte size units</a>) Unit used to display byte values.
</dd>
<dt>
<span class="term">
<code class="literal">format</code>
</span>
</dt>
<dd>
(Optional, string) Short version of the
<a href="https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html" class="ulink" target="_top">HTTP accept header</a>.
Valid values include JSON, YAML, etc.
</dd>
<dt>
<span class="term">
<code class="literal">full_id</code>
</span>
</dt>
<dd>
(Optional, boolean) If <code class="literal">true</code>, return the full node ID.  If <code class="literal">false</code>, return the
shortened node ID. Defaults to <code class="literal">false</code>.
</dd>
<dt>
<span class="term">
<code class="literal">h</code>
</span>
</dt>
<dd>
<p>
(Optional, string) Comma-separated list of column names to display.
</p>
<p>If you do not specify which columns to include, the API returns the default columns in the order listed below. If you explicitly specify one or more columns, it only returns the specified columns.</p>
<p>Valid columns are:</p>
<div class="variablelist">
<dl class="variablelist">
<dt>
<span class="term">
<code class="literal">ip</code>, <code class="literal">i</code>
</span>
</dt>
<dd>
(Default) IP address, such as <code class="literal">127.0.1.1</code>.
</dd>
<dt>
<span class="term">
<code class="literal">heap.percent</code>, <code class="literal">hp</code>, <code class="literal">heapPercent</code>
</span>
</dt>
<dd>
(Default) Maximum configured heap, such as <code class="literal">7</code>.
</dd>
<dt>
<span class="term">
<code class="literal">ram.percent</code>, <code class="literal">rp</code>, <code class="literal">ramPercent</code>
</span>
</dt>
<dd>
(Default) Used total memory percentage, such as <code class="literal">47</code>.
</dd>
<dt>
<span class="term">
<code class="literal">file_desc.percent</code>, <code class="literal">fdp</code>, <code class="literal">fileDescriptorPercent</code>
</span>
</dt>
<dd>
(Default) Used file descriptors percentage, such as <code class="literal">1</code>.
</dd>
<dt>
<span class="term">
<code class="literal">node.role</code>, <code class="literal">r</code>, <code class="literal">role</code>, <code class="literal">nodeRole</code>
</span>
</dt>
<dd>
<p>
(Default) Roles of the node. Returned values include <code class="literal">d</code> (data node), <code class="literal">i</code>
(ingest node), <code class="literal">m</code> (master-eligible node), <code class="literal">l</code> (machine learning node), <code class="literal">v</code>
(voting-only node), <code class="literal">t</code> (transform node), <code class="literal">r</code> (remote cluster client node), and <code class="literal">-</code> (coordinating node only).
</p>
<p>For example, <code class="literal">dim</code> indicates a master-eligible data and ingest node. See
<a class="xref" href="modules-node.html" title="Node">Node</a>.</p>
</dd>
<dt>
<span class="term">
<code class="literal">master</code>, <code class="literal">m</code>
</span>
</dt>
<dd>
(Default) Indicates whether the node is the elected master node. Returned values
include <code class="literal">*</code> (elected master) and <code class="literal">-</code> (not elected master).
</dd>
<dt>
<span class="term">
<code class="literal">name</code>, <code class="literal">n</code>
</span>
</dt>
<dd>
(Default) Node name, such as <code class="literal">I8hydUG</code>.
</dd>
<dt>
<span class="term">
<code class="literal">id</code>, <code class="literal">nodeId</code>
</span>
</dt>
<dd>
ID of the node, such as <code class="literal">k0zy</code>.
</dd>
<dt>
<span class="term">
<code class="literal">pid</code>, <code class="literal">p</code>
</span>
</dt>
<dd>
Process ID, such as <code class="literal">13061</code>.
</dd>
<dt>
<span class="term">
<code class="literal">port</code>, <code class="literal">po</code>
</span>
</dt>
<dd>
Bound transport port, such as <code class="literal">9300</code>.
</dd>
<dt>
<span class="term">
<code class="literal">http_address</code>, <code class="literal">http</code>
</span>
</dt>
<dd>
Bound http address, such as <code class="literal">127.0.0.1:9200</code>.
</dd>
<dt>
<span class="term">
<code class="literal">version</code>, <code class="literal">v</code>
</span>
</dt>
<dd>
Elasticsearch version, such as 7.7.1.
</dd>
<dt>
<span class="term">
<code class="literal">build</code>, <code class="literal">b</code>
</span>
</dt>
<dd>
Elasticsearch build hash, such as <code class="literal">5c03844</code>.
</dd>
<dt>
<span class="term">
<code class="literal">jdk</code>, <code class="literal">j</code>
</span>
</dt>
<dd>
Java version, such as <code class="literal">1.8.0</code>.
</dd>
<dt>
<span class="term">
<code class="literal">disk.total</code>, <code class="literal">dt</code>, <code class="literal">diskTotal</code>
</span>
</dt>
<dd>
Total disk space, such as <code class="literal">458.3gb</code>.
</dd>
<dt>
<span class="term">
<code class="literal">disk.used</code>, <code class="literal">du</code>, <code class="literal">diskUsed</code>
</span>
</dt>
<dd>
Used disk space, such as <code class="literal">259.8gb</code>.
</dd>
<dt>
<span class="term">
<code class="literal">disk.avail</code>, <code class="literal">d</code>, <code class="literal">disk</code>, <code class="literal">diskAvail</code>
</span>
</dt>
<dd>
Available disk space, such as <code class="literal">198.4gb</code>.
</dd>
<dt>
<span class="term">
<code class="literal">disk.used_percent</code>, <code class="literal">dup</code>, <code class="literal">diskUsedPercent</code>
</span>
</dt>
<dd>
Used disk space percentage, such as <code class="literal">47</code>.
</dd>
<dt>
<span class="term">
<code class="literal">heap.current</code>, <code class="literal">hc</code>, <code class="literal">heapCurrent</code>
</span>
</dt>
<dd>
Used heap, such as <code class="literal">311.2mb</code>.
</dd>
<dt>
<span class="term">
<code class="literal">ram.current</code>,<code class="literal">rc</code>, <code class="literal">ramCurrent</code>
</span>
</dt>
<dd>
Used total memory, such as <code class="literal">513.4mb</code>.
</dd>
<dt>
<span class="term">
<code class="literal">ram.max</code>, <code class="literal">rm</code>, <code class="literal">ramMax</code>
</span>
</dt>
<dd>
Total memory, such as <code class="literal">2.9gb</code>.
</dd>
<dt>
<span class="term">
<code class="literal">file_desc.current</code>, <code class="literal">fdc</code>, <code class="literal">fileDescriptorCurrent</code>
</span>
</dt>
<dd>
Used file descriptors, such as <code class="literal">123</code>.
</dd>
<dt>
<span class="term">
<code class="literal">file_desc.max</code>, <code class="literal">fdm</code>, <code class="literal">fileDescriptorMax</code>
</span>
</dt>
<dd>
Maximum number of file descriptors, such as <code class="literal">1024</code>.
</dd>
<dt>
<span class="term">
<code class="literal">cpu</code>
</span>
</dt>
<dd>
Recent system CPU usage as percent, such as <code class="literal">12</code>.
</dd>
<dt>
<span class="term">
<code class="literal">load_1m</code>, <code class="literal">l</code>
</span>
</dt>
<dd>
Most recent load average, such as <code class="literal">0.22</code>.
</dd>
<dt>
<span class="term">
<code class="literal">load_5m</code>, <code class="literal">l</code>
</span>
</dt>
<dd>
Load average for the last five minutes, such as <code class="literal">0.78</code>.
</dd>
<dt>
<span class="term">
<code class="literal">load_15m</code>, <code class="literal">l</code>
</span>
</dt>
<dd>
Load average for the last fifteen minutes, such as <code class="literal">1.24</code>.
</dd>
<dt>
<span class="term">
<code class="literal">uptime</code>, <code class="literal">u</code>
</span>
</dt>
<dd>
Node uptime, such as <code class="literal">17.3m</code>.
</dd>
<dt>
<span class="term">
<code class="literal">completion.size</code>, <code class="literal">cs</code>, <code class="literal">completionSize</code>
</span>
</dt>
<dd>
Size of completion, such as <code class="literal">0b</code>.
</dd>
<dt>
<span class="term">
<code class="literal">fielddata.memory_size</code>, <code class="literal">fm</code>, <code class="literal">fielddataMemory</code>
</span>
</dt>
<dd>
Used fielddata cache memory, such as <code class="literal">0b</code>.
</dd>
<dt>
<span class="term">
<code class="literal">fielddata.evictions</code>, <code class="literal">fe</code>, <code class="literal">fielddataEvictions</code>
</span>
</dt>
<dd>
Fielddata cache evictions, such as <code class="literal">0</code>.
</dd>
<dt>
<span class="term">
<code class="literal">query_cache.memory_size</code>, <code class="literal">qcm</code>, <code class="literal">queryCacheMemory</code>
</span>
</dt>
<dd>
Used query cache memory, such as <code class="literal">0b</code>.
</dd>
<dt>
<span class="term">
<code class="literal">query_cache.evictions</code>, <code class="literal">qce</code>, <code class="literal">queryCacheEvictions</code>
</span>
</dt>
<dd>
Query cache evictions, such as <code class="literal">0</code>.
</dd>
<dt>
<span class="term">
<code class="literal">request_cache.memory_size</code>, <code class="literal">rcm</code>, <code class="literal">requestCacheMemory</code>
</span>
</dt>
<dd>
Used request cache memory, such as <code class="literal">0b</code>.
</dd>
<dt>
<span class="term">
<code class="literal">request_cache.evictions</code>, <code class="literal">rce</code>, <code class="literal">requestCacheEvictions</code>
</span>
</dt>
<dd>
Request cache evictions, such as <code class="literal">0</code>.
</dd>
<dt>
<span class="term">
<code class="literal">request_cache.hit_count</code>, <code class="literal">rchc</code>, <code class="literal">requestCacheHitCount</code>
</span>
</dt>
<dd>
Request cache hit count, such as <code class="literal">0</code>.
</dd>
<dt>
<span class="term">
<code class="literal">request_cache.miss_count</code>, <code class="literal">rcmc</code>, <code class="literal">requestCacheMissCount</code>
</span>
</dt>
<dd>
Request cache miss count, such as <code class="literal">0</code>.
</dd>
<dt>
<span class="term">
<code class="literal">flush.total</code>, <code class="literal">ft</code>, <code class="literal">flushTotal</code>
</span>
</dt>
<dd>
Number of flushes, such as <code class="literal">1</code>.
</dd>
<dt>
<span class="term">
<code class="literal">flush.total_time</code>, <code class="literal">ftt</code>, <code class="literal">flushTotalTime</code>
</span>
</dt>
<dd>
Time spent in flush, such as <code class="literal">1</code>.
</dd>
<dt>
<span class="term">
<code class="literal">get.current</code>, <code class="literal">gc</code>, <code class="literal">getCurrent</code>
</span>
</dt>
<dd>
Number of current get operations, such as <code class="literal">0</code>.
</dd>
<dt>
<span class="term">
<code class="literal">get.time</code>, <code class="literal">gti</code>, <code class="literal">getTime</code>
</span>
</dt>
<dd>
Time spent in get, such as <code class="literal">14ms</code>.
</dd>
<dt>
<span class="term">
<code class="literal">get.total</code>, <code class="literal">gto</code>, <code class="literal">getTotal</code>
</span>
</dt>
<dd>
Number of get operations, such as <code class="literal">2</code>.
</dd>
<dt>
<span class="term">
<code class="literal">get.exists_time</code>, <code class="literal">geti</code>, <code class="literal">getExistsTime</code>
</span>
</dt>
<dd>
Time spent in successful gets, such as <code class="literal">14ms</code>.
</dd>
<dt>
<span class="term">
<code class="literal">get.exists_total</code>, <code class="literal">geto</code>, <code class="literal">getExistsTotal</code>
</span>
</dt>
<dd>
Number of successful get operations, such as <code class="literal">2</code>.
</dd>
<dt>
<span class="term">
<code class="literal">get.missing_time</code>, <code class="literal">gmti</code>, <code class="literal">getMissingTime</code>
</span>
</dt>
<dd>
Time spent in failed gets, such as <code class="literal">0s</code>.
</dd>
<dt>
<span class="term">
<code class="literal">get.missing_total</code>, <code class="literal">gmto</code>, <code class="literal">getMissingTotal</code>
</span>
</dt>
<dd>
Number of failed get operations, such as <code class="literal">1</code>.
</dd>
<dt>
<span class="term">
<code class="literal">indexing.delete_current</code>, <code class="literal">idc</code>, <code class="literal">indexingDeleteCurrent</code>
</span>
</dt>
<dd>
Number of current deletion operations, such as <code class="literal">0</code>.
</dd>
<dt>
<span class="term">
<code class="literal">indexing.delete_time</code>, <code class="literal">idti</code>, <code class="literal">indexingDeleteTime</code>
</span>
</dt>
<dd>
Time spent in deletions, such as <code class="literal">2ms</code>.
</dd>
<dt>
<span class="term">
<code class="literal">indexing.delete_total</code>, <code class="literal">idto</code>, <code class="literal">indexingDeleteTotal</code>
</span>
</dt>
<dd>
Number of deletion operations, such as <code class="literal">2</code>.
</dd>
<dt>
<span class="term">
<code class="literal">indexing.index_current</code>, <code class="literal">iic</code>, <code class="literal">indexingIndexCurrent</code>
</span>
</dt>
<dd>
Number of current indexing operations, such as <code class="literal">0</code>.
</dd>
<dt>
<span class="term">
<code class="literal">indexing.index_time</code>, <code class="literal">iiti</code>, <code class="literal">indexingIndexTime</code>
</span>
</dt>
<dd>
Time spent in indexing, such as <code class="literal">134ms</code>.
</dd>
<dt>
<span class="term">
<code class="literal">indexing.index_total</code>, <code class="literal">iito</code>, <code class="literal">indexingIndexTotal</code>
</span>
</dt>
<dd>
Number of indexing operations, such as <code class="literal">1</code>.
</dd>
<dt>
<span class="term">
<code class="literal">indexing.index_failed</code>, <code class="literal">iif</code>, <code class="literal">indexingIndexFailed</code>
</span>
</dt>
<dd>
Number of failed indexing operations, such as <code class="literal">0</code>.
</dd>
<dt>
<span class="term">
<code class="literal">merges.current</code>, <code class="literal">mc</code>, <code class="literal">mergesCurrent</code>
</span>
</dt>
<dd>
Number of current merge operations, such as <code class="literal">0</code>.
</dd>
<dt>
<span class="term">
<code class="literal">merges.current_docs</code>, <code class="literal">mcd</code>, <code class="literal">mergesCurrentDocs</code>
</span>
</dt>
<dd>
Number of current merging documents, such as <code class="literal">0</code>.
</dd>
<dt>
<span class="term">
<code class="literal">merges.current_size</code>, <code class="literal">mcs</code>, <code class="literal">mergesCurrentSize</code>
</span>
</dt>
<dd>
Size of current merges, such as <code class="literal">0b</code>.
</dd>
<dt>
<span class="term">
<code class="literal">merges.total</code>, <code class="literal">mt</code>, <code class="literal">mergesTotal</code>
</span>
</dt>
<dd>
Number of completed merge operations, such as <code class="literal">0</code>.
</dd>
<dt>
<span class="term">
<code class="literal">merges.total_docs</code>, <code class="literal">mtd</code>, <code class="literal">mergesTotalDocs</code>
</span>
</dt>
<dd>
Number of merged documents, such as <code class="literal">0</code>.
</dd>
<dt>
<span class="term">
<code class="literal">merges.total_size</code>, <code class="literal">mts</code>, <code class="literal">mergesTotalSize</code>
</span>
</dt>
<dd>
Size of current merges, such as <code class="literal">0b</code>.
</dd>
<dt>
<span class="term">
<code class="literal">merges.total_time</code>, <code class="literal">mtt</code>, <code class="literal">mergesTotalTime</code>
</span>
</dt>
<dd>
Time spent merging documents, such as <code class="literal">0s</code>.
</dd>
<dt>
<span class="term">
<code class="literal">refresh.total</code>, <code class="literal">rto</code>, <code class="literal">refreshTotal</code>
</span>
</dt>
<dd>
Number of refreshes, such as <code class="literal">16</code>.
</dd>
<dt>
<span class="term">
<code class="literal">refresh.time</code>, <code class="literal">rti</code>, <code class="literal">refreshTime</code>
</span>
</dt>
<dd>
Time spent in refreshes, such as <code class="literal">91ms</code>.
</dd>
<dt>
<span class="term">
<code class="literal">script.compilations</code>, <code class="literal">scrcc</code>, <code class="literal">scriptCompilations</code>
</span>
</dt>
<dd>
Total script compilations, such as <code class="literal">17</code>.
</dd>
<dt>
<span class="term">
<code class="literal">script.cache_evictions</code>, <code class="literal">scrce</code>, <code class="literal">scriptCacheEvictions</code>
</span>
</dt>
<dd>
Total compiled scripts evicted from cache, such as <code class="literal">6</code>.
</dd>
<dt>
<span class="term">
<code class="literal">search.fetch_current</code>, <code class="literal">sfc</code>, <code class="literal">searchFetchCurrent</code>
</span>
</dt>
<dd>
Current fetch phase operations, such as <code class="literal">0</code>.
</dd>
<dt>
<span class="term">
<code class="literal">search.fetch_time</code>, <code class="literal">sfti</code>, <code class="literal">searchFetchTime</code>
</span>
</dt>
<dd>
Time spent in fetch phase, such as <code class="literal">37ms</code>.
</dd>
<dt>
<span class="term">
<code class="literal">search.fetch_total</code>, <code class="literal">sfto</code>, <code class="literal">searchFetchTotal</code>
</span>
</dt>
<dd>
Number of fetch operations, such as <code class="literal">7</code>.
</dd>
<dt>
<span class="term">
<code class="literal">search.open_contexts</code>, <code class="literal">so</code>, <code class="literal">searchOpenContexts</code>
</span>
</dt>
<dd>
Open search contexts, such as <code class="literal">0</code>.
</dd>
<dt>
<span class="term">
<code class="literal">search.query_current</code>, <code class="literal">sqc</code>, <code class="literal">searchQueryCurrent</code>
</span>
</dt>
<dd>
Current query phase operations, such as <code class="literal">0</code>.
</dd>
<dt>
<span class="term">
<code class="literal">search.query_time</code>, <code class="literal">sqti</code>, <code class="literal">searchQueryTime</code>
</span>
</dt>
<dd>
Time spent in query phase, such as <code class="literal">43ms</code>.
</dd>
<dt>
<span class="term">
<code class="literal">search.query_total</code>, <code class="literal">sqto</code>, <code class="literal">searchQueryTotal</code>
</span>
</dt>
<dd>
Number of query operations, such as <code class="literal">9</code>.
</dd>
<dt>
<span class="term">
<code class="literal">search.scroll_current</code>, <code class="literal">scc</code>, <code class="literal">searchScrollCurrent</code>
</span>
</dt>
<dd>
Open scroll contexts, such as <code class="literal">2</code>.
</dd>
<dt>
<span class="term">
<code class="literal">search.scroll_time</code>, <code class="literal">scti</code>, <code class="literal">searchScrollTime</code>
</span>
</dt>
<dd>
Time scroll contexts held open, such as <code class="literal">2m</code>.
</dd>
<dt>
<span class="term">
<code class="literal">search.scroll_total</code>, <code class="literal">scto</code>, <code class="literal">searchScrollTotal</code>
</span>
</dt>
<dd>
Completed scroll contexts, such as <code class="literal">1</code>.
</dd>
<dt>
<span class="term">
<code class="literal">segments.count</code>, <code class="literal">sc</code>, <code class="literal">segmentsCount</code>
</span>
</dt>
<dd>
Number of segments, such as <code class="literal">4</code>.
</dd>
<dt>
<span class="term">
<code class="literal">segments.memory</code>, <code class="literal">sm</code>, <code class="literal">segmentsMemory</code>
</span>
</dt>
<dd>
Memory used by segments, such as <code class="literal">1.4kb</code>.
</dd>
<dt>
<span class="term">
<code class="literal">segments.index_writer_memory</code>, <code class="literal">siwm</code>, <code class="literal">segmentsIndexWriterMemory</code>
</span>
</dt>
<dd>
Memory used by index writer, such as <code class="literal">18mb</code>.
</dd>
<dt>
<span class="term">
<code class="literal">segments.version_map_memory</code>, <code class="literal">svmm</code>, <code class="literal">segmentsVersionMapMemory</code>
</span>
</dt>
<dd>
Memory used by version map, such as <code class="literal">1.0kb</code>.
</dd>
<dt>
<span class="term">
<code class="literal">segments.fixed_bitset_memory</code>, <code class="literal">sfbm</code>, <code class="literal">fixedBitsetMemory</code>
</span>
</dt>
<dd>
Memory used by fixed bit sets for nested object field types and type filters for
types referred in <a class="xref" href="parent-join.html" title="Join datatype"><code class="literal">join</code></a> fields, such as <code class="literal">1.0kb</code>.
</dd>
<dt>
<span class="term">
<code class="literal">suggest.current</code>, <code class="literal">suc</code>, <code class="literal">suggestCurrent</code>
</span>
</dt>
<dd>
Number of current suggest operations, such as <code class="literal">0</code>.
</dd>
<dt>
<span class="term">
<code class="literal">suggest.time</code>, <code class="literal">suti</code>, <code class="literal">suggestTime</code>
</span>
</dt>
<dd>
Time spent in suggest, such as <code class="literal">0</code>.
</dd>
<dt>
<span class="term">
<code class="literal">suggest.total</code>, <code class="literal">suto</code>, <code class="literal">suggestTotal</code>
</span>
</dt>
<dd>
Number of suggest operations, such as <code class="literal">0</code>.
</dd>
</dl>
</div>
</dd>
<dt>
<span class="term">
<code class="literal">help</code>
</span>
</dt>
<dd>
(Optional, boolean) If <code class="literal">true</code>, the response includes help information. Defaults
to <code class="literal">false</code>.
</dd>
<dt>
<span class="term">
<code class="literal">local</code>
</span>
</dt>
<dd>
(Optional, boolean)
<span class="Admonishment Admonishment--change">
[<span class="Admonishment-version u-mono u-strikethrough">7.6.0</span>]
<span class="Admonishment-detail">
Deprecated in 7.6.0. This parameter does not cause this API to act locally. It will be removed in version 8.0.
</span>
</span>
If <code class="literal">true</code>, the request computes the list of selected nodes from the local
cluster state. Defaults to <code class="literal">false</code>, which means the list of selected nodes is
computed from the cluster state on the master node. In either case the
coordinating node sends a request for further information to each selected
node.
</dd>
<dt>
<span class="term">
<code class="literal">master_timeout</code>
</span>
</dt>
<dd>
(Optional, <a class="xref" href="common-options.html#time-units" title="Time units">time units</a>) Specifies the period of time to wait for
a connection to the master node. If no response is received before the timeout
expires, the request fails and returns an error. Defaults to <code class="literal">30s</code>.
</dd>
<dt>
<span class="term">
<code class="literal">s</code>
</span>
</dt>
<dd>
(Optional, string) Comma-separated list of column names or column aliases used
to sort the response.
</dd>
<dt>
<span class="term">
<code class="literal">time</code>
</span>
</dt>
<dd>
(Optional, <a class="xref" href="common-options.html#time-units" title="Time units">time units</a>)
Unit used to display time values.
</dd>
<dt>
<span class="term">
<code class="literal">v</code>
</span>
</dt>
<dd>
(Optional, boolean) If <code class="literal">true</code>, the response includes column headings.
Defaults to <code class="literal">false</code>.
</dd>
</dl>
</div>
</div>

<div class="section">
<div class="titlepage"><div><div>
<h3 class="title">
<a id="cat-nodes-api-example"></a>Examples<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elastic/elasticsearch/edit/7.7/docs/reference/cat/nodes.asciidoc">edit</a>
</h3>
</div></div></div>
<div class="section">
<div class="titlepage"><div><div>
<h4 class="title">
<a id="cat-nodes-api-ex-default"></a>Example with default columns<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elastic/elasticsearch/edit/7.7/docs/reference/cat/nodes.asciidoc">edit</a>
</h4>
</div></div></div>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">GET /_cat/nodes?v</pre>
</div>
<div class="console_widget" data-snippet="snippets/1364.console"></div>
<p>The API returns the following response:</p>
<div class="pre_wrapper lang-txt">
<pre class="programlisting prettyprint lang-txt">ip        heap.percent ram.percent cpu load_1m load_5m load_15m node.role master name
127.0.0.1           65          99  42    3.07                  dim       *      mJw06l1</pre>
</div>
<p>The <code class="literal">ip</code>, <code class="literal">heap.percent</code>, <code class="literal">ram.percent</code>, <code class="literal">cpu</code>, and <code class="literal">load_*</code> columns provide the
IP addresses and performance information of each node.</p>
<p>The <code class="literal">node.role</code>, <code class="literal">master</code>, and <code class="literal">name</code> columns provide information useful for
monitoring an entire cluster, particularly large ones.</p>
</div>

<div class="section">
<div class="titlepage"><div><div>
<h4 class="title">
<a id="cat-nodes-api-ex-headings"></a>Example with explicit columns<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elastic/elasticsearch/edit/7.7/docs/reference/cat/nodes.asciidoc">edit</a>
</h4>
</div></div></div>
<p>The following API request returns the <code class="literal">id</code>, <code class="literal">ip</code>, <code class="literal">port</code>, <code class="literal">v</code> (version), and <code class="literal">m</code>
(master) columns.</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">GET /_cat/nodes?v&amp;h=id,ip,port,v,m</pre>
</div>
<div class="console_widget" data-snippet="snippets/1365.console"></div>
<p>The API returns the following response:</p>
<div class="pre_wrapper lang-txt">
<pre class="programlisting prettyprint lang-txt">id   ip        port  v         m
veJR 127.0.0.1 59938 7.7.1 *</pre>
</div>
</div>

</div>

</div>
<div class="navfooter">
<span class="prev">
<a href="cat-nodeattrs.html">« cat nodeattrs API</a>
</span>
<span class="next">
<a href="cat-pending-tasks.html">cat pending tasks API »</a>
</span>
</div>
</div>

                  <!-- end body -->
                        </div>
                        <div class="col-xs-12 col-sm-4 col-md-4" id="right_col">
                        
                        </div>
                    </div>
                </div>
            </section>
        </div>
    </section>
</div>
<script src="../static/cn.js"></script>
</body>
</html>